The Client/Server Service version of Web+(tm) runs as a service on Windows NT. Since it runs as a service, Web+(tm) will be able to respond to web requests even when no user is logged in on the Web+ server.
The Client/Server NT Executable Version (for NT only)
The Client/Server Exe version runs as an application on Windows NT. Web+(tm) will respond to web requests only when a user is logged in and Web+(tm) is running.
The Desktop Executable version (for Win95 & NT)
===============================================
The Desktop Exe version runs as an application on Windows 95 and Windows NT.
-------------------------
Starting up with Web+(tm)
-------------------------
Installing Web+(tm) on your computer
====================================
1. When you download Web+(tm) from TalentSoft's Web server, you receive an Installation Password and a License ID. You will need these to install Web+(tm). If you have any questions about them, please contact TalentSoft Technical Support.
2. Download the self-extracting executable file WEBP21NT.EXE or WEBP21DT.EXE into a temporary directory. Run the file to begin installing Web+(tm) 2.1 on your machine. The setup program will begin running and prompt you to enter the Installation Password which you received when you downloaded Web+(tm) from TalentSoft.
3. Select the directory into which you want to install Web+(tm) 2.1. By default, Web+(tm) 2.1 is installed in the directory c:\webplus.
4. If the directory exists, the setup program will prompt you to back it up. Back up your previous version of Web+ in c:\webplus\backup or a different directory of your choosing.
5. Enter your name and company name in the appropriate text boxes. Enter the License ID which you received when you downloaded Web+(tm) into the License ID text box.
6. Choose an Administration Password. You will use this password in some other applications like Web+(tm) Administration Manager. Enter the Administrator's e-mail address. If you want to allow remote administration, enter the IP Address Range from which remote administration will be allowed.
7. Web+(tm) uses logical names to refer to physical paths on your server. Type in any physical paths in which you want to store Web+(tm) scripts and the logical names you want to assign to those paths. By default, the logical path "/" will be mapped to the physical path "c:\webplus\script\" (if you selected c:\webplus\ as your installation directory above). This is the path which contains the example scripts supplied with Web+(tm). You do not need to enter any other path names at this time. Enter the path to the directory in which you want the Web+(tm) log file to be created.
8. If you wish to use the SMTP mail capability provided by Web+(tm), enter the name and port number of your mail server and the path names of the log, spool, and error directories.
9. The ODBC datasource name for our example applications is webplus_Examples. You will be prompted to connect to the database later on in the setup program. The WebPlus example database, by default, is c:\webplus\database\WebplusExamples.mdb.
10. Type in any physical paths in which you want Web+(tm) to be able to do file I/O operations, and the logical names you want to assign to those paths.
11. Enter the server root path and the CGI directory.
You should see Web+(tm) 2.1 being installed onto your machine. The information you have entered during installation is stored in the Web+(tm) configuration file WEBPSVR.INI. To make changes later, you can edit this file manually or use the Web+(tm) Administration Manager.
After installation, you should see the following directory tree.
C:\WEBPLUS
| README.TXT
|
+---BIN
| INSTWSVC.EXE - NT service installation program
| (for Client/Server versions only)
|
| WEBP_MSG.INI - All Web+(tm) information and error messages.
| (this file must put under NT system directory (c:\winnt))
|
| WEBPLUS.EXE - CGI executable program
|
| WEBPLUS.INI - An initialization file.
| (this file must put under NT system directory (c:\winnt))
|
| WEBPSVC.EXE - Web+(tm) service program
| (for Client/Server Service version only)
|
| WEBPSVR.EXE - Web+(tm) server program
| (for Client/Server Executable version only)
|
| WEBPSVR.INI - Web+(tm) server initialization file
| (this file must put under NT system directory (c:\winnt))
|
+---DATABASE
| WEBPLUSEXAMPLES.MDB - Microsoft Access database for examples
|
+---DOC
| GETTING STARTED.DOC
| WEBPREF.DOC - Web+(tm) Language Reference (MS Word)
| LANGSUM.DOC
|
+---LOG
| WEBPLUS.LOG - Log of errors in Web+(tm) scripts
|
+---MAIL
| \---LOG
| \---SPOOL
| \---ERROR
|
+---SCRIPT - Script root directory
\---WEBPLUS
+---ADMIN - Scripts for Administration Manger
+---BUBBLE - Scripts for Bubble Sort
+---CONTACT - Scripts for Contact Manager
+---GUESTBOOK - Scripts for Guestbook
+---MATHWIZARD - Scripts for Math Wizard
+---PRIME - Scripts for generation prime numbers
+---Secure - Scripts for User Authentication
+---TCPIP - Scripts for demonstrating Web+Socket
+---TEST - Scripts for function testing
+---TUTOR - Scripts for Online Tutorial
+---UNITCONVERT - Scripts for Unit Conversion
+---VALIDATE - Scripts for demonstrating #ValidateCC# function
+---WEBMAIL - Scripts for webMail
+---WEBPING - Scripts for WebPing
+---WEBTALK - Scripts for Web+Talk(tm)
+---WISDOM - Scripts for Wisom
The most important files provided with Web+(tm) are the ones in c:/WebPlus/bin. If you did not receive all these files, please contact Technical Support as listed in the Appendices.
When the Web+(tm) server, webpsvc.exe, stops, the Web+(tm) client, webplus.exe, will trigger TalentSoft Web+(tm) service to restart. In order to have such service, the following two steps must be followed: put webplus.ini under Windows NT system directory, then set AutoStartService=1 in webplus.ini. If the service is started successfully, there should be no error messages concerning the "Communication Error" when you start running your applications. To append your error message in the webplus.log file, set LogAppend=1, otherwise, webplus.log will be overwritten every time the Web+ service restarts.
The following is a brief description on how to automatically restart the Server, webpsvc.exe, in the Web+Ö by the client, webplus.exe.
1. Webplus.ini configuration file has to be put under the Windows NT system directory which is c:\winnt
2. Configure the webplus.ini in the following format.
[Main]
PipeOrSocket = 0
WebpServerIP = 127.0.0.1 (your server IP address)
AutoStartService = 1
3. To prevent overwriting webplus.log, set
[Log]
:
LogAppend=1
in webpsvr.ini.
Setting up ODBC Datasources
---------------------------
For detailed information and instructions, please visit our site at: http://www.talentsoft.com and select 'Teach Me Web+(tm).'
There are two steps you must take to use a database with Web+(tm): you must create an ODBC datasource for the database, and then you must configure Web+(tm) to make the datasource available to Web+(tm). To protect datasources against unauthorized access by scripts, Web+(tm) will not connect to a datasource it has not been configured to recognize.
Creating an ODBC datasource
===========================
1. In the Control Panel, double-click the 'ODBC' (or '32bit ODBC')icon. A dialog box titled 'Data Sources' will appear.
2. Choose the 'System DSN' button. A dialog box titled 'System Data Sources' will appear.
3. In the System Data Sources dialog box, select the 'Add...' button. A list will appear containing all the ODBC drivers on your system.
4. Select the driver corresponding to the database you want Web+ to be able to use. Click 'OK.' A dialog box will appear in which you may enter information about the new datasource.
5. Choose a name for your data source. You will use this name to identify the data source in your Web+ Scripts.
6. If you wish, enter a description of the data source.
7. Click the 'Select...' button and select the database you want to make available to Web+. Alternatively, you may select another button and create a new database or repair or compact an existing database.
8. Click 'OK' to add the datasource to your system's list of system data sources.
Making your data source available to Web+(tm)
============================================
1. Go to the Web+(tm) Administration Manager (webplus.exe?script=/WebPlus/admin/admin.wml)
2. Log in to Administration Manager and select the 'ODBC' button to view the ODBC Datasource Configuration page. Find the 'Add New Datasource' section at the bottom of the page.
3. Enter the name you gave the data source when you created it above.
4. If you are using an ODBC driver that requires a user name and password, enter them.
5. If you wish, enter a Connect Time-out time.
6. Choose which SQL actions you want to allow Web+(tm) scripts to do. Check the appropriate boxes.
7. Hit the 'Add New ODBC' button at the bottom of the page to save the entries you have just made.
You will now be able to access your database from your Web+(tm) scripts.
----------------------------
Writing a simple Web+ script
----------------------------
The contents of your script
===========================
A Web+ script need not contain any special Web+ tags; any hypertext file can be used as a Web+ script. Try typing this simple example with any text editor:
<html>
<head>
<title>Hello, World</title>
</head>
<body>
<h1>Hello, World!</h1>
</body>
</html>
Saving your script
==================
Web+(tm) allows the administrator to control which directories can contain Web+(tm) scripts by designating certain directories as script root directories. Web+(tm) can execute a script only if it is in a script root or a subdirectory of a script root.
When you first install Web+(tm), the default script root directory is
c:\webplus\script\
which is mapped to the logical path
/
You can save your script as c:\webplus\script\Test\MyScript.wml.
How to call the script from your browser
========================================
You run your scripts by executing Web+ from your Web browser and passing Web+ the name of the script you want to run. To tell Web+ which script to run, type the name of the script, using its logical path name, in the URL when you call Web+:
NOTE: TalentSoft will not provide any technical support for Web+ if the template files are modified in anyway not explicitly instructed in the official documentation. Please refer to our Web+Ö Conference for any problems.
